Identificación

Este endpoint permite extraer la información de identificación asociada a un RUT previamente cargado en tu cuenta de Sheriff.

• No se generará ningún costo adicional al consultar información de un RUT ya cargado en la plataforma.
• Asegúrate de que el RUT esté pre-cargado en la plataforma antes de intentar extraer su información.

Detalle de API

Request

• URL: /helper/identificacion/{rut}
• Método: GET

Parámetros

• rut (requerido): El RUT del cual se desea extraer la información. Formato del rut "12345678-9".

Ejemplo request con curl

curl -X 'GET' \
  'https://prod.api.thesheriff.cl/api/clients/v2/helper/identificacion/12345678-9' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9EjemploDeToken123' \
  -H 'x-client-identifier: SheriffSecureClient-v1'

Response

Success

• Status code: 200

• Example response body:

  {
    "success": true,
    "data": {
      "identificacion": {
        "razonSocial": "Empresa S.A.",
        "presentaActividades": "SI",
        "inicioActividades": "10-10-2020",
        "autorizadoMonedaExtranjera": "NO",
        "empresaMenor": "SI",
        "observaciones": "Observaciones adicionales sobre la identificación del contribuyente.",
        "actividadEconomicaVigente": [
          {
            "actividades": "HOTELERIA",
            "codigo": "000000",
            "categoria": "Primera",
            "afectaIva": "Si",
            "fecha": "12-10-2020"
          },
          {
            "actividades": "OTRAS ACTIVIDADES DE SERVICIOS DE INFORMACION",
            "codigo": "000001",
            "categoria": "Primera",
            "afectaIva": "Si",
            "fecha": "15-10-2020"
          }
        ],
        "documentosTimbrados": [
          {
            "documento": "Factura Electronica",
            "ultimoAnioTimbrado": "2025"
          },
          {
            "documento": "Factura No Afecta O Exenta Electronica",
            "ultimoAnioTimbrado": "2025"
          }
        ],
        "cantidadActividades": 2,
        "cantidadDocumentos": 2
      },
      "tamanoEmpresaSii": {
        "periodo": 2024,
        "tamanoEmpresa": "Pequeña empresa",
        "ventasAnuales": "10.000,01 a 25.000,00",
        "cantidadTrabajadores": 12
      },
      "ultimaActualizacion": "02-03-2026 10:00:00"
    }
  }

  A continuación se describen los campos devueltos en la respuesta JSON.

  Campo	Tipo	Descripción
  success	bool	Indica si la operación fue exitosa.
  data	object	Contiene la información detallada del contribuyente.

  Campos dentro de data:

  Campo	Tipo	Descripción
  identificacion	object	Información de identificación del contribuyente.
  tamanoEmpresaSii	object	Información sobre el tamaño de la empresa según el SII.
  ultimaActualizacion	string	Fecha y hora de la última actualización de la información.

  Estructura de cada objeto dentro de identificacion:

  Campo	Tipo	Descripción
  razonSocial	string	Razón social del contribuyente.
  presentaActividades	string	Indica si el contribuyente presenta actividades registradas ("SI"/"NO").
  inicioActividades	string	Fecha de inicio de actividades (formato: "dd-mm-aaaa").
  autorizadoMonedaExtranjera	string	Indica autorización para operar en moneda extranjera ("SI"/"NO").
  empresaMenor	string	Indica si es una empresa menor ("SI"/"NO").
  observaciones	string	Observaciones y recomendaciones del SII sobre el contribuyente.
  notas	string	Información adicional o aclaratoria publicada por la fuente.
  situacionActual	string	Situación del contribuyente en nóminas o listados del SII.
  actividadEconomicaVigente	array	Lista de actividades económicas vigentes (ver estructura abajo).
  documentosTimbrados	array	Lista de tipos de documentos timbrados y su último año timbrado.
  cantidadActividades	number	Cantidad de actividades económicas registradas.
  cantidadDocumentos	number	Cantidad de tipos de documentos timbrados reportados.

  Estructura de cada elemento dentro de actividadEconomicaVigente:

  Campo	Tipo	Descripción
  actividades	string	Nombre de la actividad económica.
  codigo	string	Código de actividad.
  categoria	string	Categoría asociada a la actividad (ej: "Primera").
  afectaIva	string	Indica si la actividad afecta IVA ("Si"/"No").
  fecha	string	Fecha asociada a la actividad (formato "dd-mm-aaaa").

  Estructura de cada elemento dentro de documentosTimbrados:

  Campo	Tipo	Descripción
  documento	string	Nombre del tipo de documento (ej: "Factura Electronica").
  ultimoAnioTimbrado	string	Último año en el que el documento fue timbrado.

  Nota: Los campos marcados como "No" pueden no estar presentes o ser null según disponibilidad de datos en la fuente.

  Errores

  400 - Solicitud inválida

  {
    "success": false,
    "code": 400,
    "error": "Solicitud inválida"
  }

  401 - No autorizado

  {
    "success": false,
    "code": 401,
    "error": "No autorizado"
  }

  403 - No tienes permiso para acceder a este recurso

  {
    "success": false,
    "code": 403,
    "error": "No tienes permiso para acceder a este recurso"
  }

  404 - Recurso no encontrado

  {
    "success": false,
    "code": 404,
    "error": "Recurso no encontrado"
  }

  408 - Tiempo de espera agotado

  {
    "success": false,
    "code": 408,
    "error": "Tiempo de espera agotado"
  }

  429 - Demasiadas solicitudes

  {
    "success": false,
    "code": 429,
    "error": "Demasiadas solicitudes"
  }

  500 - Error interno del servidor

  {
    "success": false,
    "code": 500,
    "error": "Error interno del servidor"
  }